home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 March
/
EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso
/
earcd
/
program
/
ixemlsrc.lha
/
ixemul
/
man
/
cat3
/
ungetc.0
< prev
next >
Wrap
Text File
|
1995-12-23
|
2KB
|
67 lines
UNGETC(3) UNIX Programmer's Manual UNGETC(3)
NNAAMMEE
uunnggeettcc - unget character from input stream
SSYYNNOOPPSSIISS
##iinncclluuddee <<ssttddiioo..hh>>
_i_n_t
uunnggeettcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m)
DDEESSCCRRIIPPTTIIOONN
The uunnggeettcc() function pushes the character _c (converted to an unsigned
char) back onto the input stream pointed to by _s_t_r_e_a_m. The pushedbacked
characters will be returned by subsequent reads on the stream (in reverse
order). A successful intervening call, using the same stream, to one of
the file positioning functions (fseek(3), fsetpos(3), or rewind(3))
will discard the pushed back characters.
One character of pushback is guaranteed, but as long as there is suffi
cient memory, an effectively infinite amount of pushback is allowed.
If a character is successfully pushedback, the endoffile indicator for
the stream is cleared.
RREETTUURRNN VVAALLUUEESS
The uunnggeettcc() function returns the character pushedback after the conver
sion, or EOF if the operation fails. If the value of the argument _c
character equals EOF, the operation will fail and the stream will remain
unchanged.
SSEEEE AALLSSOO
getc(3), fseek(3), setvbuf(3)
SSTTAANNDDAARRDDSS
The uunnggeettcc() function conforms to ANSI C3.1591989 (``ANSI C'').
BSD Experimental June 29, 1991 1